package com.zjcloud.academic.service;

import com.zjcloud.academic.domain.AcCourseSchedule;
import java.util.List;

/**
 * 课表管理Service接口
 * 
 * @author zjcloud
 * @date 2024-01-01
 */
public interface IAcCourseScheduleService 
{
    /**
     * 查询课表管理
     * 
     * @param id 课表管理主键
     * @return 课表管理
     */
    public AcCourseSchedule selectAcCourseScheduleById(Long id);

    /**
     * 查询课表管理列表
     * 
     * @param acCourseSchedule 课表管理
     * @return 课表管理集合
     */
    public List<AcCourseSchedule> selectAcCourseScheduleList(AcCourseSchedule acCourseSchedule);

    /**
     * 根据学期查询课表列表
     * 
     * @param semesterId 学期ID
     * @return 课表列表
     */
    public List<AcCourseSchedule> selectAcCourseScheduleBySemesterId(Long semesterId);

    /**
     * 根据日期范围查询课表列表
     * 
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @param semesterId 学期ID
     * @return 课表列表
     */
    public List<AcCourseSchedule> selectAcCourseScheduleByDateRange(String startDate, String endDate, Long semesterId);

    /**
     * 新增课表管理
     * 
     * @param acCourseSchedule 课表管理
     * @return 结果
     */
    public int insertAcCourseSchedule(AcCourseSchedule acCourseSchedule);

    /**
     * 修改课表管理
     * 
     * @param acCourseSchedule 课表管理
     * @return 结果
     */
    public int updateAcCourseSchedule(AcCourseSchedule acCourseSchedule);

    /**
     * 批量删除课表管理
     * 
     * @param ids 需要删除的课表管理主键集合
     * @return 结果
     */
    public int deleteAcCourseScheduleByIds(Long[] ids);

    /**
     * 删除课表管理信息
     * 
     * @param id 课表管理主键
     * @return 结果
     */
    public int deleteAcCourseScheduleById(Long id);

    /**
     * 根据学期ID删除课表
     * 
     * @param semesterId 学期ID
     * @return 结果
     */
    public int deleteAcCourseScheduleBySemesterId(Long semesterId);

    /**
     * 检查课表冲突
     * 
     * @param acCourseSchedule 课表信息
     * @return 是否存在冲突
     */
    public boolean checkScheduleConflict(AcCourseSchedule acCourseSchedule);

    /**
     * 生成排课任务
     * 
     * @param semesterId 学期ID
     * @param algorithmConfigId 算法配置ID
     * @return 生成结果
     */
    public boolean generateCourseSchedule(Long semesterId, Long algorithmConfigId);

    /**
     * 获取课表统计信息
     * 
     * @param semesterId 学期ID
     * @return 统计信息
     */
    public com.zjcloud.academic.service.IntelligentScheduleService.ScheduleStatistics getScheduleStatistics(Long semesterId);
}